home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 June
/
EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso
/
earcd
/
utmisc1
/
xpkrchvp.lha
/
XpkArchivePackage
/
XArcTool.dok
< prev
next >
Wrap
Text File
|
1996-05-07
|
12KB
|
283 lines
XArcTool V2.0
=============
© 1995 by Matthias Meixner
Einführung
----------
XArcTool ist eine graphische Benutzeroberfläche für die xpkarchive.library.
Die Oberfläche ist dabei an Directory-Tools wie Opus oder Directorymaster
angelehnt und gestattet es Archive genauso einfach zu handhaben wie normale
Verzeichnisse. Man kann damit Dateien in Archive kopieren, Dateien aus
Archiven extrahieren, Dateien zwischen verschiedenen Archiven kopieren, ohne
sie dabei zu dekomprimieren und neu zu komprimieren, und als Zugabe auch
Dateien wie mit einem normalen Directory-Tool zwischen zwei Verzeichnissen
zu kopieren. Ausserdem ist es mit der xpkarchive.library auch möglich Dateien
in einem Archiv umzubenennen, Kommentare zu Dateien anzulegen oder zu ändern
und die Schutzbits zu ändern. Die xpkarchive.library bietet die Möglichkeit
mehrere Versionen einer Datei in einem Archiv zu halten, dabei haben alle
diese Versionen den gleichen Dateinamen. Um dies zu erreichen hat jede Datei
zusätzlich noch eine Dateigenerationsnummer. Je höher diese
Generationsnummer, desto neuer ist diese Datei (jedenfalls gilt dies solange
man die Generationsnummer nicht manuell umgesetzt hat). Version 0 hat eine
besondere Bedeutung, sie bezieht sich immer auf die Datei mit der höchsten
Generationsnummer und damit i.d.R. auf die neueste Version einer Datei.
All diese Funktionen werden bereits von der xpkarchive.library angeboten und
XArcTool ist nur eine komfortable Benutzerschnittstelle zu dieser Library.
Falls Sie die xpkarchive.library selbst benutzen wollen, lesen sie bitte die
Dokumentation, die mit der xpkarchive.library kommt.
Die Oberfläche von XArcTool ist bis zu einem gewissen Grad fontsensitiv.
Falls der Font bei einem kleinen Fenster sehr gross ist, kann es passieren,
daß die Texte nicht mehr in die Gadgets passen und so das Layout etwas
durcheinander gerät. In diesem Fall reicht es jedoch aus, das Fenster zu
vergrößern oder einen anderen Font zu wählen. Auf die Funktionalität hat
dies jedoch keinen Einfluß.
Copyright
---------
XArcTool (C) Copyright 1995 by Matthias Meixner. Alle Rechte vorbehalten.
Dieses Programm ist GIFTWARE, was bedeutet, daß Sie, wenn Ihnen dieses
Programm gefällt und sie es regelmäßig benutzen, den Autor mit einem
angemessenen Geschenk belohnen sollten.
Dieses Programmpaket darf frei kopiert werden, solange es nur in seiner
originalen Form, komplett und unmodifiziert weitergegeben wird. Es darf
nicht kommerziell oder als Teil eines kommerziellen Programms ohne meine
schriftliche Genehmigung vertrieben werden. Hiermit erhält Fred Fish die
Erlaubnis dieses Programm auf seiner PD-Serie zu veröffentlichen.
Dieses Programm wird in der Hoffnung vertrieben, daß es nützlich ist, aber
ohne jegliche Garantie, daß es einen bestimmten Zweck erfüllt. Die Benutzung
geschieht auf eigene Gefahr!
Aufruf
------
Mit einem Doppelklick auf das "Installiere_Lib"-Icon wird die
xpkarchive.library installiert. Danach kann man einfach die komplette
Schublade in das Verzeichnis schieben, wo man XArcTool haben will.
vom CLI:
XArcTool PATH/M,P=PACKER/K,M=MODE/N,PW=PASSWD/K,L=LEFT/N,T=TOP/N,W=WIDTH/N,
H=HEIGHT/N,I=ICON/S
Option: Effekt:
PATH/M Hiermit kann man zwei Pfade angeben, die von XArcTool verwendet
werden sollen. Dabei kann es sich auch um Archive handeln, die
angezeigt werden sollen.
z.B. XArctool ram: hd0:
P=PACKER Wählt die standardmäßige Packmethode aus.
M=MODE Wählt den standardmäßigen Packmodus aus.
PW=PASSWD Wählt das standardmäßige Paßwort für die Verschlüsselung aus.
L=LEFT,
T=TOP,
W=WIDTH,
H=HEIGHT Dient zum Angeben der Position und der Größe des Fensters von
XArcTool. LEFT und TOP geben dabei die linke obere Ecke an und
WIDTH und HEIGHT die Breite und die Höhe des Fensters.
I=ICON Mit dieser Option erzeugt XarcTool Icons.
Ein weiteres Beispiel:
XArcTool P=FEAL M=100 PW=test ICON ram:
Hiermit benutzt XArcTool die Verschlüsselungsmethode FEAL im Modus 100
und verwendet "test" als Paßwort. Der Pfad der linken Verzeichnisliste
ist "ram:". Außerdem werden Icons für neu erzeugte Archive angelegt.
Aufruf von der Workbench:
Mit der Workbench kann man die gleichen Optionen wie vom CLI benutzen.
Dazu ergänzt man einfach pro Option eine Zeile in den Tooltypes des Icons.
Außerdem kann man die PATH-Option über mehrfache Selektion der Workbench
ausnutzen. Dazu klickt man zuerst XArcTool einfach an, drückt die
Shift-Taste und klickt danach Verzeichnisse oder Archive an und beendet dies
mit einem Doppelklick auf dem letzten Icon. Sehr nützlich in diesem
Zusammenhang sind die the LEFT,TOP,WIDTH und HEIGHT Optionen, mit denen man
die Position und Größe des Fensters einstellen kann.
Benutzen von XArcTool
---------------------
Beim Start öffnet XArcTool ein Fenster mit zwei Verzeichnislisten, eine auf
der linken und eine auf der rechten Seite. Die TextGadgets darüber enthalten
den Pfadnamen der Verzeichnisse, die gerade angezeigt werden. Das obere der
beiden Textgadgets enthält dabei den Pfad auf dem Datenträger und das untere
der beiden den Pfad innerhalb eines Archivs, falls im oberen Textgadget
ein Archiv angewählt wurde. Der Pfeil in der Mitte zwischen dem linken und
dem rechten Textgadget gibt an, in welcher Richtung kopiert wird und legt
damit das Quellverzeichnis und das Zielverzeichnis fest. Das
Quellverzeichnis ist jeweils das Verzeichnis, von dem der Pfeil wegzeigt.
Alle Operationen beziehen sich immer auf das Quellverzeichnis.
Archive werden genauso gehandhabt wie Verzeichnisse, nur mit dem Unterschied,
daß zusätzliche Funktionen möglich sind. Falls man also eine Datei aus einem
Verzeichnis in ein Archiv kopiert, so wird sie dabei automatisch komprimiert,
während sie dekomprimiert wird, wenn man sie aus einem Archiv in ein
Verzeichnis kopiert. Kopieren zwischen zwei Archiven führt nicht zu einer
Dekompression und einer neuen Kompression dieser Datei und ist deshalb recht
schnell.
Anlegen von Archiven oder Verzeichnissen:
Dazu tippt man einfach den Namen des Verzeichnisses bzw. des Archivs in das
Textgadget für den Pfad ein. Daraufhin erscheint ein Requester, der angibt,
daß dieses Objekt nicht existiert und fragt, ob man es als Verzeichnis oder
als Archiv anlegen möchte. Archive erhalten automatisch die Endung ".xar",
falls sie nicht schon eine Endung angegeben haben.
Außerdem kann man dazu auch die Knöpfe "Neues Verz." oder "Neues Arch."
verwenden, um ein neues Verzeichnis oder ein neues Archiv anzulegen.
Kopieren/Komprimieren/Dekomprimieren von Dateien:
Dazu selektiert man einfach mit einem Mausklick die zu kopierenden Dateien
oder wählt Dateien über ein Muster mit dem Menü aus und wählt danach
"Kopieren" an. Abhängig von den angewählten Verzeichnissen/Archiven werden
die Dateien (De)Komprimiert oder einfach kopiert.
Mit einem Doppelklick auf ein Verzeichnis kann man in dieses hinabsteigen,
mit einem Doppelklick auf ein Archiv in dieses hineinwechseln.
Umbenennen von Dateien:
Einfach die Dateien anwählen und auf "Benennen" klicken. Daraufhin
erscheint ein Requester, in dem man den neuen Namen angeben kann und falls
die Datei einem Archiv angehört auch die Dateigeneration ändern kann.
Genauso kann man auch Verzeichnisse umbenennen.
(Siehe auch die Information zu den Dateigenerationen)
Dateien löschen:
Man löscht Dateien einfach indem man sie selektiert und "Löschen" anwählt.
Dateien innerhalb von Archiven werden in Abhängigkeit vom Archivtyp nur
als gelöscht markiert. Die Dateien werden dann erst mit "Packen" aus dem
Archiv entfernt.
"Wiederherst." dient nun dazu die Löschmarkierung von Dateien zu entfernen,
das Löschen also rückgängig zu machen. Dies ist natürlich nur dann möglich,
wenn die Datei nicht bereits aus dem Archiv entfert wurde.
Mit "Kommentar" kann man Dateikommentare sezten, mit "Schutz" die
Schutzbits der Dateien ändern.
Archive Packen:
"Packen" entfernt alle als gelöscht markierten Dateien aus einem Archiv und
außerdem überflüssige Informationen, die durch Umbenennen von Dateien oder
durch Setzen von neuen Dateikommentaren entstanden sind. Nachdem ein Archiv
gepackt wurde, ist es nicht mehr möglich gelöschte Dateien
wiederherzustellen.
Mit "Direkt-Kom." kann man eine Kommandozeile direkt an die
archive-sublibrary schicken. Die Funktion ist dabei nur von der Sublibrary
abhängig. (Siehe die Dokumentation der Sublibrary).
Mit "Optionen" kann man eine andere Packmethode oder einen anderen Packmodus
einstellen, desweiteren kann man hier auch das Paßwort einstellen, das bei
den Verschlüsselungsverfahren verwendet wird, falls ein solches eingestellt
wurde.
"/" dient dazu in ein übergeordnetes Verzeichnis zu wechseln.
"Lesen" liest das Quellverzeichnis neu ein. Dies ist notwendig, wenn von
einem anderen Programm eine Datei in dieses Verzeichnis geschrieben wurde
und diese angezeigt werden soll.
Das Listview-Gadget unterhalb des "Lesen"-Gadgets erlaubt das Auswählen
eines neuen Datenträgers für das Quellverzeichnis.
"Sync"-Gadget:
Dieses Gadget ist äußerst nützlich. Wenn es aktiviert ist, geschehen alle
Verzeichniswechsel durch Doppelklick auf einen Eintrag in einer
Verzeichnisliste oder durch Klick auf "/" synchron auf beiden Seiten. Dies
erlaubt ein einfaches Duplizieren von kompletten Verzeichnisstrukturen.
Menüs:
------
Projekt
Über: Informationen über XArcTool.
Ende: XArcTool beenden
Extras:
Alles markieren: Markiert alle Dateien im Quellverzeichnis
Muster markieren: Benutzt ein Muster, um Dateien im Quellverzeichnis zu
markieren.
Alles demarkieren: Demarkiert alle Dateien des Quellverzeichnisses.
Muster demarkieren: Benutzt ein Muster, um Dateien im Quellverzeichnis zu
demarkieren.
Was XArcTool so alles anzeigt
-----------------------------
XArcTool zeigt folgende Informationen in den Verzeichnislisten an:
Für normale Verzeichnisse (in dieser Reihenfolge):
Dateiname Dateigröße Schutzbits Datum&Zeit Dateikommentar
Für Archive:
Dateiname Generationsnummer (Komprimierte Größe) Dateigröße Packmethode
Schutzbits Datum&Zeit Dateikommentar
Dateigenerationen
-----------------
Die xpkarchive.library kann mehrere Versionen einer Datei mit dem gleichen
Dateinamen in einem Archiv halten. Diese werden durch ihre Generationsnummer
unterschieden (d.h. sogar wenn mehrere Dateien die gleiche Versionsnummer
haben, kann man sie immer noch per Mausklick auswählen!).
Die xpkarchive.library versucht die Generationsnummern auf einem sinnvollen
Stand zu halten. Falls man also z.B. eine Datei an ein Archiv anhängt, in
dem bereits eine Datei mit dem gleichen Namen existiert, so erhält die neue
Datei die nächst höhere Generationsnummer. Die Generationsnummer 0 hat eine
besondere Bedeutung: sie bezieht sich auf die Datei mit der höchsten
Generationsnummer (mit einem bestimmten Namen), also in der Regel auf
die neueste Datei eines Namens.
History
-------
2.0: Unterstützung für die neuen Funktionen der xpkarchive.library V2.0
1.4: verwendete SetWindowPointer unter V37, was jedoch erst ab V39 existiert,
korrigiert
1.3: erste öffentlich verfügbare Version
Was zu tun bleibt:
Eine bessere Dokumentation schreiben.
Falls Sie Fehler finden, Fragen haben oder ??? schreiben Sie an:
Matthias Meixner
Sandberg 13
36145 Schwarzbach
Deutschland
EMail:
meixner@rbg.informatik.th-darmstadt.de